Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

changeObjectInstance

This procedure changes the object instance.

Location: ry\app\rydesmngrp.i

Parameters:

INPUT pcNameContainer AS CHARACTER

The container name. Takes a valid container name or a value of ALL for all containers.

INPUT pcResultCode AS CHARACTER

Takes a valid result code, the name of a Master container, or ? (Unknown) for ALL.

INPUT pcNameObjectInstance AS CHARACTER INPUT pcNameObjectSource AS CHARACTER

The name of the source object to be replaced with the target object. Takes a valid object name.

INPUT pcNameObjectTarget AS CHARACTER

The name of the target object to replace the source object. Takes a valid object name.

INPUT plDeleteObjectSource AS LOGICAL

Deletes the source object if all instances have been changed and there are no other instance allocations.

INPUT plRemoveDefaultAttributes AS LOGICAL

Removes default attributes set for the object instances.

INPUT plRemoveUnusedAttributes AS LOGICAL

Removes unused attributes set for the object instances.

OUTPUT piReplacementCount AS INTEGER Notes:

If both the source and target objects are valid objects and exist within the same class hierarchy, the instance and its attribute values are updated accordingly.
Unless you specify a container name, the procedure works for all containers. If you specify a container name, it works only for the relevant container.
If the object exists on a container multiple times, all instances are changed unless a specific object instance name is given.
All the attribute values contained in the attribute value table that are set against the INSTANCE owner are set against this object.
Examples: See the trgbuReplace procedure in ry\prc\ryreplinstvp.p.